home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / programmmanager / runlist-kinder / runlist.doc < prev    next >
Text File  |  1996-04-07  |  3KB  |  76 lines
  1.  
  2.                  RunList v1.2
  3.                  ------------
  4.  
  5.                   © 1994 David Kinder
  6.                   -------------------
  7.  
  8. Introduction
  9. ------------
  10.  
  11. RunList is a commodity to lauch commonly used programs. When activated,
  12. a user defined list of commands is displayed, any one of which can be
  13. activated by clicking on a gadget or by pressing a function key. If
  14. required, RunList can also add an item to the Workbench 'Tools' menu to
  15. activate RunList.
  16.  
  17. Use
  18. ---
  19.  
  20. From the Shell, the template is
  21.  
  22.     CX_PRIORITY/N/K,CX_POPKEY/K,CX_POPUP/K,MENU/S
  23.  
  24. The first three arguments are standard for commodities, and determine the
  25. commodity's priority, its hotkey, and whether or not it should activate on
  26. startup. The defaults correspond to calling RunList with
  27.  
  28.     RunList CX_PRIORITY=0 CX_POPKEY="shift alt help" CX_POPUP=NO
  29.  
  30. The menu switch determines whether RunList should add an item to the
  31. Workbench 'Tools' menu. By default RunList will not do this.
  32.  
  33. From Workbench, the standard commodity tooltypes CX_PRIORITY, CX_POPKEY and
  34. CX_POPUP can be used, exactly as per the Shell arguments. The tooltype MENU
  35. functions identically to the Shell switch of the same name.
  36.  
  37. Once running, press the hotkey (default Shift-Alt-Help), or (if available)
  38. select the 'Tools' menu item 'RunList' to activate the RunList window. A
  39. window containing gadgets corresponding to the configuration file (see
  40. below) will appear. Click on the appropriate gadget to start the required
  41. program. Alternatively, the first ten programs can be started by pressing a
  42. function key (F1 corresponding to the first gadget, F2 to the second, etc.).
  43.  
  44. The window can be closed by clicking on its close gadget, or by selecting
  45. 'Hide' from the 'Project' menu. RunList can be permanently de-activated by
  46. selecting 'Quit' from the 'Project' menu.
  47.  
  48. Configuration File
  49. ------------------
  50.  
  51. On startup, RunList looks for the file "RunList.config", first in the
  52. startup directory, and then in S:. The file should consist of lines, each
  53. one representing a single gadget. The format is the text that should appear
  54. in the gadget, followed by a vertical bar ('|'), then the command to run,
  55. e.g.
  56.     MultiView|SYS:Utilities/MultiView
  57.  
  58. Finally
  59. -------
  60.  
  61. RunList was compiled with Dice 2.07.56R. If you have any comments, etc.
  62. direct them to
  63.  
  64.     kinder@teaching.physics.ox.ac.uk
  65. or    dkinder@vax.ox.ac.uk
  66.  
  67. History
  68. -------
  69.  
  70. v1.0    First release.
  71.  
  72. v1.1    Changed default hotkey to "shift alt help" to avoid conflict with
  73.     AmigaDOS 2.0 Commodities program.
  74.  
  75. v1.2    Ensures that the screen which the window opens on is in front.
  76.